home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 51 / Amiga Format CD51 (2000-03-10)(Future Publishing)(GB)[!][issue 2000-04].iso / -in_the_mag- / pdselect / awnp / awnp-docs / overview.doc < prev    next >
Text File  |  2000-02-16  |  3KB  |  44 lines
  1.  This section is very technical in nature. It is intended as a reference for people already familiar with AWNP. To learn how to use pipe functions work through the tutorials. The pipe function sections are NOT required reading to learn how to build GUI's.
  2.  
  3. Pipenames
  4. ---------
  5.  
  6. AWNPipe:test/h AWNPipe:test AWNPipe:test/h/f/rhelpme are all the same file. The unique name terminates on the first '/' or the end of the name if no '/' is found. '%' may be substituted for  '/' .
  7.  
  8. Options are usually given as single characters after a '/' .The  /x /r /e and /w options can be followed by multiple characters . AWNPipe:test/HTML/TAP AWNPipe:test/H/t are both the same. Options should be given in lower case. All options after 'r' 'w' or 'e' are ignored since they may be followed by a path name.
  9.  
  10. A pipe name can only be opened twice. After that calls to open will fail ( unless the multiple opens was specified). After both ends of the pipe are closed the pipe name can  be used again. A pipe can immediately be written after it is opened even if the other end is not yet created. Taps and some special options can override this behavior.
  11.  
  12. All file handles (but taps) can both read or write data. No check is made to see if pipes dead lock from pending reads on both end. Data flow is never stopped by buffering. If a pipe is written and never read it stores all written data.... forever. This can use up all your memory.
  13.  
  14.  
  15. Examples show only a one directional pipe. All file handles but taps can both read or write data.
  16.  
  17. data in and out of a pipe.
  18.  
  19. echo "hello World" > AWNPipe:test
  20. type AWNPipe:test
  21.  
  22.  
  23. Pipe Types
  24. ----------
  25.  
  26. /I immediate   /U unHTML        /E execute    /L link
  27. /R read        /P Postaweb      /O <option>   /V[unit#] readclip
  28. /W write       /! do not wait   /B backwards  /C[unit#] writeclip
  29. /H HTML        /T tap           /F force      /S status
  30. /G HTML2       /A Abort         /-vers# minimum version
  31. /@ seek enable /M Multiple Opens   /1 open first end
  32.  
  33. /x[option] extra function
  34.       /xi[filename] read tooltype information for a file.
  35.       /xc open interactive Class Act pipe
  36.       /xcr[filename] open interactive Class Act pipe, reading the window and gadget definitions from a separate file.
  37.       /xcw[filename] open interactive Class Act window, writing the events to a separate file.(also sets immediate and force)
  38.       /xm[c]    string pattern match c=case sensitive
  39.       /xm[c]w    string pattern match c=case sensitive results to separate file
  40.       /xm[c]r    string pattern match c=case sensitive reading data from separate file. (also sets immediate and force)
  41.       /x0 programmable replace loopback
  42.       /x0r[filename] programmable replace from file
  43.       /x0w[filename] programmable replace to file
  44.